home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / reward12.zip / REWARD.DOC < prev    next >
Text File  |  1992-03-13  |  10KB  |  253 lines
  1.  
  2.  
  3.                              Upload Reward
  4.                        Reward your Top Uploaders
  5.  
  6.                    For use with PCBoard Version 14.x
  7.  
  8.                               REWARD12.ZIP
  9.                          Version 1.2, 03-13-92
  10.  
  11.                      This program is supported by:
  12.                            The Tool Shop BBS
  13.                            Panorama City, CA
  14.                           (818) 891-6780 (Free Line)
  15.                           (818) 891-3772 (HST)
  16.                           (818) 891-1340 (Hayes-V)
  17.  
  18.                   Copyright 1989-1992 Samuel H. Smith
  19.  
  20.  
  21.  
  22. Upload Reward is a utility program to generate a bulletin of your best
  23. uploaders, and optionally assign them to special security levels.
  24.  
  25. Features:
  26.  
  27.         *       Can reward users in multiple security levels and later
  28.                 return them to the original levels
  29.  
  30.         *       Correctly handles expired users, automatically updating
  31.                 the expired user levels rather than un-expired levels.
  32.  
  33.         *       Full sysop control over report header and footer text
  34.  
  35.         *       Generates detailed execution log
  36.  
  37.         *       Network compatible (I still recommend running the update
  38.                 only when all nodes are offline)
  39.  
  40.         *       Uses advanced buffering for quick execution
  41.  
  42.         *       Multiple configuration files may be used.  Use this in
  43.                 conjunction with multiple events to vary rewards
  44.                 according to "prime time" or other criteria you
  45.                 determine.
  46.  
  47.  
  48. Usage:
  49.    reward CONFIGFILE
  50.  
  51. Where:
  52.    CONFIGFILE specifies the configuration file to be used.
  53.  
  54.  
  55. Sample configuration file: REWARD.CNF
  56. =====================================
  57.  
  58.    REWARD.HDR
  59.    REWARD.TLR
  60.    \PCB\GEN\BLT99
  61.    REWARD.LOG
  62.    \PCB\MAIN\USERS
  63.    40
  64.    4
  65.    10 11
  66.    50 51
  67.    60 61
  68.    70 71
  69.  
  70.    ----------------------------------
  71.    Reward Configuration File Format:
  72.  
  73.    line 1 = Report header text file name (NUL if none)
  74.  
  75.    line 2 = Report trailer text file name (NUL if none)
  76.  
  77.    line 3 = Report bulletin output file name (NUL if none)
  78.  
  79.    line 4 = Reward activity log output file name (NUL if none)
  80.  
  81.    line 5 = Full pathname of USERS file
  82.  
  83.    line 6 = Number of users to reward
  84.  
  85.    line 7 = Number of security level table entries
  86.  
  87.    line 8 = First security table entry
  88.  
  89.    Security table entries are in the format
  90.       NORMAL BONUS
  91.    where
  92.       NORMAL is the normal user level and
  93.       BONUS is the level assigned to reward a top uploader.
  94.  
  95. SAMPLE OUTPUT
  96. =============
  97.                    The Tool Shop's BEST UPLOADERS
  98.  
  99.   User Name               Calling From             Last On   # of UL's  Level
  100.   _________               ____________             ________  _________  _____
  101.  
  102.   JACK DAUGHERTY          CANTON, MI               03-06-92     2013      71
  103.   ED LUCAS                HOUSTON, TX              03-05-92      844      71
  104.   JOHN MESKEW             NORTH HOLLYWOOD CALIF.   03-12-92      269      11
  105.   PAT SHEA                BETHLEHEM, PA            01-09-92      232      71
  106.   CHARLES BURDSAL         WICHITA, KS              03-12-92      156      71
  107.   RICHARD SAEKS           HINSDALE, IL             03-03-92      154      11
  108.   DOUG HAIRE              JACKSONVILLE, FL         03-13-92      142      71
  109.   MARK RAPP               VERONA, NJ               03-12-92      142      71
  110.   JEFF BACON              TEMPE, AZ                03-01-92      141      11
  111.   DANIEL WALKER           CHICAGO, IL              03-12-92      129      11
  112.   LARRY OTTERSBACH        TEMPE, AZ                02-15-92      125      71
  113.   CALVIN CURTINDOLPH      CHICAGO, IL              02-08-92      118      71
  114.   GLENN ALLEN             APACHE JUNCTION, AZ      03-02-92      114      71
  115.   DAVID QUINTIERI         SCOTTSDALE, AZ           04-13-91      109      71
  116.   RON FAIRCLOTH           TEMPE, AZ                03-04-92      107      11
  117.   ERNEST HINTZ            SAN MATEO, CA            02-29-92      106      73
  118.   MIKE ZED                LONG BEACH, CA           03-04-92      104      71
  119.   HERBERT WOLFF           TEMPE, AZ                07-01-91      102      51
  120.   WALTER DEWITT           GLENDALE, AZ             03-12-92      102      11
  121.   STEVE SCOGGINS          GLENDALE, AZ             06-16-91      100      51
  122.   FRED SOHN               PHOENIX AZ               02-29-92       93      71
  123.   STEPHEN MINTZ           PHOENIX,AZ               02-28-92       93      51
  124.   RON HERRING             GRAY, TN                 03-04-92       91      71
  125.   RUDY SOLIS              SYLMAR, CA               03-12-92       85      73
  126.   TIM MOELLER             OAK RIDGE, TN            04-26-91       82      11
  127.   JOHN FEDOR              PHOENIX, AZ              03-10-92       78      71
  128.   LYNN NASH               POMONA CA                03-07-92       77      11
  129.   DANIEL MADURA           SAN DIEGO, CA            03-07-92       70      11
  130.   NORM HENKE              CLEVELAND, OH            02-15-92       69      71
  131.   WES BRZOZOWSKI          ENDICOTT, NY             03-08-92       69      11
  132.   DAVE LARDNER            LOUISVILLE, KY           03-04-92       69      11
  133.   BILL WALSH              ALEXANDRIA, VA.          03-09-92       65      71
  134.   JEFF SABATINI           BETHESDA, MD             03-08-92       65      51
  135.   DAVE COOPER             MESA, AZ                 03-01-92       63      11
  136.   ED RALEIGH              GLENDALE, AZ             03-07-92       62      71
  137.   JIM MIDDLETON           GLENDALE,AZ              01-05-92       61      11
  138.   DAVE NAVARRO            BROOKLYN, NY             03-11-92       60      71
  139.   WARREN SANASAC          SPRINGFIELD, VA          01-15-92       60      71
  140.   LUKE OWENS              LOS ANGELES, CA          12-25-91       59      51
  141.   GORDON GREENBLATT       PHOENIX AZ               07-09-91       57      11
  142.   JOSEPH SHEPPARD         TUJUNGA, CA              02-16-92       54      71
  143.   DAVID PETERSON          ST. CLOUD, MN            02-13-92       53      11
  144.   KEITH OSTERHOUT         TAHLEQUAH, OK            03-04-92       52      11
  145.   GARY BOUCHARD           ST. AUGUSTINE, FLORIDA   03-11-92       50      71
  146.   JOHN BINTZ              DAVIS, CA                12-31-91       50      51
  147.   DWIGHT RINGDAHL         CHICAGO, IL              02-13-92       50      51
  148.   GEORGE LYKOS            PHX, AZ                  01-24-92       50      11
  149.  
  150.            As a reward for uploading, these users have been granted
  151.            access to all Tool Shop nodes:
  152.                    Phone number         Modem type
  153.                   --------------    ---------------------
  154.                   (818) 891-3772    US Robotics 2400
  155.                   (818) 891-1344    Hayes-V series 9600
  156.                   (818) 891-6780    US Robotics HST 9600
  157.  
  158. LICENSE
  159. =======
  160.  
  161.    SourceWare: What is it?
  162.    -----------------------
  163.  
  164.    SourceWare is my name for a unique concept in user supported
  165.    software.
  166.  
  167.    Programs distributed under the SourceWare concept always include
  168.    complete source code.
  169.  
  170.    This package can be freely distributed so long as it is not modified
  171.    or sold for profit.  If you find that this program is valuable,  you
  172.    can send me a donation for what you think it is worth.  I suggest
  173.    about $10.
  174.  
  175.    Send your contributions to:
  176.       Samuel H. Smith
  177.       P.O. Box 4808
  178.       Panorama City CA 91412-4808
  179.  
  180.  
  181.    Why SourceWare?
  182.    ---------------
  183.  
  184.    Why do I include source code?  Why isn't the donation manditory?  The
  185.    value of good software should be self-evident. The source code is the
  186.    key to complete understanding of a program.  You can read it to find
  187.    out how things are done.  You can also change it to suit your needs,
  188.    so long as you do not distribute the modified version without my
  189.    consent.
  190.  
  191.  
  192.    Copyright
  193.    ---------
  194.  
  195.    If you modify this program, I would appreciate a copy of the new
  196.    source code.   I am holding the copyright on the source code, so
  197.    please don't delete my name from the program files or from the
  198.    documentation.
  199.  
  200.  
  201.  
  202. DISCLAIMER
  203. ==========
  204.  
  205. I cannot be responsible for any damages resulting from the use or misuse
  206. of this program!
  207.  
  208. IN NO EVENT WILL I BE  LIABLE TO  YOU FOR  ANY DAMAGES, INCLUDING  ANY
  209. LOST  PROFITS,  LOST  SAVINGS  OR OTHER INCIDENTAL OR CONSEQUENTIAL
  210. DAMAGES ARISING OUT OF YOUR USE OR  INABILITY TO  USE THE PROGRAM, OR
  211. FOR ANY CLAIM BY ANY OTHER PARTY.
  212.  
  213.  
  214.  
  215. REVISION HISTORY
  216. ================
  217.  
  218.    13-Mar-92   1.2    Added user level to report.
  219.  
  220.    05-Mar-92   1.1    Added logic to check and update the "expired"
  221.                       security level on users who are "expired"
  222.                       according to the expiration date field of the user
  223.                       record.  Also removed the need for a "sorting"
  224.                       procedure for much quicker execution.
  225.  
  226.    17-Sep-89   1.0    Initial coding.  I wrote it because I wanted to
  227.                       allow my best uploaders to access the
  228.                       "subscription" lines of the Tool Shop BBS.  I
  229.                       couldn't find any other utility with the
  230.                       flexibility I needed.
  231.  
  232. SUPPORT
  233. =======
  234.  
  235.    I work very hard to produce a software package of the highest quality
  236.    and functionality.  I try to look into all reported bugs, and will
  237.    generally fix reported problems within a few days.
  238.  
  239.    Since this is user supported software under the SourceWare concept, I
  240.    don't expect you to contribute if you don't like it or if it doesn't
  241.    meet your needs.
  242.  
  243.    If you have any questions, bugs, or suggestions, please contact me
  244.    at:
  245.        The Tool Shop BBS
  246.         (818) 891-6780
  247.  
  248.    The latest version is always available for downloading.
  249.  
  250.    Enjoy!     Samuel H. Smith
  251.               Author and Sysop of The Tool Shop.
  252.  
  253.